PATH Mac OS 8 and 9 Developer Documentation > Text and Other International Services > Apple Type Services for Unicode Imaging (ATSUI) > Apple Type Services for Unicode Imaging Reference
     

ATSUCopyLayoutControls

Copies all the text layout attribute values in a text layout object.

OSStatus ATSUCopyLayoutControls (
                     ATSUTextLayout iSource,
                     ATSUTextLayout iDest);
iSource
A reference of type ATSUTextLayout. Pass a reference to an initialized text layout object whose attributes you want to copy. You cannot pass NULL for this parameter.

iDest
A reference of type ATSUTextLayout. Pass a reference to an initialized text layout object whose attributes you want to replace. You cannot pass NULL for this parameter.

function result
A result code. See Result Codes.
DISCUSSION
The ATSUCopyLayoutControls function copies all the text layout attribute values in a text layout object. This includes previously set attributes as well as unset ones, which ATSUI sets to the default values listed in Table C-2. If you wish to copy the text layout attribute values of a single line in a text layout object, see the function ATSUCopyLineControls.

ATSUCopyLayoutControls does not copy the contents of memory referenced by pointers or handles within reference constants. You are responsible for ensuring that this memory remains valid until the source text layout object is disposed of.

SPECIAL CONSIDERATIONS
ATSUCopyLayoutControls may allocate memory in your application heap, unless you designate a different heap by calling the function ATSUCreateMemorySetting.

VERSION NOTES
Available beginning with ATSUI 1.0.

© 2000 Apple Computer, Inc. – (Last Updated 25 Jan 00)